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What is it? 

holmatic's ZX-WESPI project (pronounced Vespi) is so named because it's based on an Expressif 
Systems ESP32 microcontroller and because it means 'Waspy' in German. It's a ZX81 modification 
which provides 1024KB of local file storage, a wifi enabled web server, and seamless hooking of the 
native LOAD and SAVE commands. It's a total replacement for a tape recorder which fits hidden 
inside the ZX81 case - so it's ideal if your Zeddy already has the 16K internal RAM mod. The wifi 
antenna is even integrated into the PCB. 


Why is it good? 

e It's cheap - the ESP32 controller is available for around £7.50, and only three resistors and a 
single capacitor are required 

e It's relatively easy to build - only 4 wires connect to the ZX81 

e The software integration is top notch 

e It supports normal LOAD and SAVE commands 

e The loading is very fast indeed, only a second or two for a 16K game 

e It senses when a jack is connected for comms with a real tape recorder/maxduino/tzxduino and 
will not trigger 


e It can be updated over the air, no future disassembly of the ZX81 needed 
e Even the graphic design of the wasp logo is great! 


Files and documentation 
The WESPI mod exists in two flavours: 
e https: //github.com/holmatic/zx-iot-mi - a ‘minimal-invasive’ version with as simple a design as 
possible to focus on the fileserver 
e https://github.com/holmatic/zx-iot-video - a 'video' version with the same fileserver core but 
with LCD and VGA support 
The GitHub documentation for the video version is more comprehensive than for the ‘mi’ variant, so 
for the latter you will need to refer to a translation of the post on the German 'tlienhard.com’ 
forum: https://translate.google.com/translate? ... 26t%3D3360 


As a precaution | have triggered a web.archive.org crawl of that page. 


Sourcing the microcontroller 

The main pitfall to building a WESPI seems to be ordering a compatible microcontroller since there 
are so many variants. The forum thread has some back and forth about that, with photos which 
allow comparison with what you may find on eBay. You need a 30pin model and it seems the 
antenna should not be hanging over the back edge of the PCB as it is for many of the ones on eBay. 
| bought this one, sub type "30pin ESP-32 unweld”. | bought it without the pin headers attached to 
allow for a lower profile installation, as recommended in the guide. 


The next sticking point is that to flash the firmware to the microcontroller you need Microsoft 
Windows (so you probably need a VM on MacOS or Linux) and you also are likely to need to 
download and install a USB-to-UART serial port driver since the peripheral components on ESP32 
boards do vary somewhat. You need to do this to get the board to present a new COM port in Device 
Manager which the flashing software will target. This is detailed in the German forum thread. The 
VCP driver (virtual COM port) linked there worked for me. Running binaries and drivers from 
obscure Chinese electronics manufacturers isn't ideal from a security perspective, so | used an old 
Surface device | seldom use. | also scanned the downloaded files with www.virustotal.com. Once 
the board is flashed, you can confirm WESPI is running because when the controller boots the blue 
LED should blink intermittently. From factory the blue LED will not be lit, only the red one. 


Assembly 

You will need insulating tubing or heatshrink. | used silicone insulated wire which doesn't melt, and 
| found | was able to assemble all of this quite easily. | soldered the capacitor first, then | soldered 
the two resistors together, then joined those to the board and one of them to the capacitor, then | 
added the power leads to the capacitor. Finally | added the EAR and display wires, tucking wires 
through the capacitor legs for support since it was going to be dangling a lot during testing. | chose 
to solder the wires to points on the underside of the ZX81 motherboard because it's easier. Also the 
mod is then conspicuous to anyone who opens the machine in future, and they can be careful not to 
yank anything unintentionally. 


Voltage regulator 

Though the guide leaves it up to the reader whether to change the 7805 regulator for a modern 
switching one, | would strongly recommend doing that. | measured that the WESPI added 200mA of 
current draw to the existing 290mA of the ZX81 and the heatsink was nearly hot enough to burn my 
hand after a sustained period with the case on. That was using a modern regulated 9V mains 
adaptor, so it would be even worse with the stock Sinclair PSU. | have ordered the Traco TSR 1-2450 
1A switching regulator which is available for a reasonable price at retrorevivalshop (out of stock at 
the time of writing). Resident hardware guru 1024MAK confirmed that a 1A regulator is adequate, 
even with a ZX Printer attached so long as the PSU is at least 1.2A rated. This is because the printer 
takes most of its power from the +9V input supply, not the regulated +5V. 


Installation into the case 

| will update this post one I've fitted the new regulator and settled on the best way to fit the WESPI 
to the case. My initial thought had been to use hot glue to secure it to the bottom shell (avoiding 
direct contact with the keyboard for heat reasons) but this complicates future disassembly because 
the motherboard attaches to the top shell. The original regulator and heatsink will come out, so | 
think placing it near that location might be best to allow the case to open like a book (the wires all 
attach to that side of the board after all). A sturdy piece of adhesive hook & loop fastener tape 
might be the best way to attach it, like many people used to secure RAM packs. It's less permanent 
than glue if you want to take the motherboard out again in future. 


Operation 

Once the ZX81 is back up and running you'll notice that the WESPI hooks the regular LOAD ™ 
command. It senses the loss of vsync and sends a loader program to the EAR. That splash screen 
allows you to select a Wifi network and enter the key material. For characters not present on ZX81 
(like '!’) you can run your key through an ASCII to Hex converter and enter a hex string instead. Very 
elegant. Once connected you can upload your .p files via the web server from another computer, 
and they will appear in the ZX81 menu screen next time it refreshes. The loading is incredibly fast 
from that point onwards, considering the WESPI still has to send the data over the EAR connection. 


Updating 

This wasn't obvious: do note that the version of the WESPI software in the initial flash bundle isn't 
the latest, so once it's up and running go back to GitHub and get the latest zx_iot.bin file and 
upload it via the web server. Leave it time to perform the flash before resetting the ZX81 and you'll 
notice that you can now see the MAC address in the wifi config page and also that the web server 
now reports how much free storage space there is in the flash memory. 


All in all the WESPI is an absolutely superb piece of engineering, and a fun little project to build. | 
thoroughly recommend it! 


